-- $Id$
-- $Source$
-- ****************************************************************
-- CISCO-FRAS-HOST-MIB.my:  Cisco FRAS Host MIB
-- 
-- January 1997, Bob Batz
--
-- Copyright (c) 1997 by cisco Systems, Inc.
-- All rights reserved.
-- ****************************************************************
--
-- $Log$
--
-- $Endlog$
--

CISCO-FRAS-HOST-MIB DEFINITIONS ::= BEGIN

--  MIB definitions for Cisco FRAS Host support.
--
--  This MIB contains the information necessary 
--  for the definition and management of FRAS Host objects.
--
--  The following FRAS Host objects are supported:
--
--      (1) frasHostAdminObjects = FRAS Host Configuation information 
--
--      (2) frasHostConnObjects  = FRAS Host Connection Information.
--
--
--  NOTE: Please reference the Router Products Configuration Guide
--        and/or the Router Products Command Reference for additional
--        information about FRAS Host parameters.
--

IMPORTS
        MODULE-IDENTITY, OBJECT-TYPE,
        Counter32
                FROM SNMPv2-SMI

        TimeStamp, RowStatus, TruthValue, 
        TEXTUAL-CONVENTION
                FROM SNMPv2-TC

        InterfaceIndex
                FROM IF-MIB

        MacAddressNC
                FROM DLSW-MIB

        SAPType
                FROM CISCO-TC
       
        MODULE-COMPLIANCE, OBJECT-GROUP
                FROM SNMPv2-CONF

--PSIM(Modif)   ciscoExperiment
        ciscoMgmt
                FROM CISCO-SMI;

ciscoFrasHostMIB MODULE-IDENTITY
        LAST-UPDATED    "9703100000Z"
        ORGANIZATION    "Cisco Systems, Inc."
        CONTACT-INFO  
                "       Cisco Systems
                        Customer Service

                Postal: 170 West Tasman Drive
                        San Jose, CA  95134
                        USA

                   Tel: +1 800 553-NETS

                E-mail: cs-fras@cisco.com"
        DESCRIPTION
            "This is the Management Information Base (MIB)
    module for objects used to manage the cisco FRAS Host
    function on the Cisco Router. 

     *************************************************
    * Acronym Definitions:                            *
    * FRAS   =   Frame Relay Access Support           *
    * BNN    =   Boundary Network Node                *
    * BAN    =   Boundary Access Node                 *
     *************************************************

    The function of FRAS Host is to provide access to a Host
    system for remote Frame Relay Access Devices or FRAS 
    routers.  Both BNN and BAN flavors of SNA RFC1490 
    encapsulation are supported.  Typically, a Cisco 7x00 router 
    with a Channel Interface Processor card utilizing Cisco SNA 
    is used to interface with a host system.  Examples of FRAD 
    access to the host using this feature are below:

    Host * CIP SNA * SRB * FRAS Host * Frame Relay * FRAD * Ring * PS/2

              |**************** LLC-2 ****************|**** LLC-2 ****|

                                        OR

    Host * CIP SNA * SRB * FRAS Host * Frame Relay * FRAD * SDLC device

              |**************** LLC-2 ****************|***** SDLC *****|

                                        OR

    Host * CIP SNA * DLSw * FRAS Host * Frame Relay * FRAD * Ring * PS/2

             |* LLC-2 *|********** LLC-2 *************|**** LLC-2 ****|

                                        OR

    Host * CIP SNA * DLSw * FRAS Host * Frame Relay * FRAD * SDLC device

             |* LLC-2 *|********** LLC-2 *************|**** SDLC ****|


        The following tables are supported:

        1) frasHostBnnAdminTable:  Each entry in this table corresponds 
           to a single Cisco router command of the form:

           fras-host bnn Serial 'n' fr-lsap 'sap' hmac 'mac' hsap 'sap'.

        2) frasHostBanAdminTable:  Each entry in this table corresponds 
           to a single Cisco router command of the form:

           fras-host ban Serial 'n' hmac 'mac' bni 'bnimac'.

        3) frasHostDlswLocalAckTable:  Each entry in the table corresponds
           to a single Cisco router command of the formL

            fras-host dlsw-local-ack

        4) frasHostConnTable:  Each entry in this table corresponds to 
           a single BNN or BAN LLC-2 connection between a remote FRAD
           or FRAS router and a host.
    "
        REVISION        "9703100000Z"
        DESCRIPTION
                "Use new SAP Textual Convention from CISCO-TC MIB."
        REVISION        "9702120000Z"
        DESCRIPTION
                "Initial Version of this MIB module."
        ::= { ciscoMgmt 71 }

-- ***************************************************************
-- Define frasHostObjects
-- ***************************************************************
frasHostObjects             OBJECT IDENTIFIER ::= { ciscoFrasHostMIB 1 }
frasHostAdminObjects        OBJECT IDENTIFIER ::= { frasHostObjects 1 }
frasHostConnObjects         OBJECT IDENTIFIER ::= { frasHostObjects 2 }

--
-- Define frasHostBnnAdminTable
--
frasHostBnnAdminTable OBJECT-TYPE
        SYNTAX  SEQUENCE OF FrasHostBnnAdminEntry
        MAX-ACCESS  not-accessible
        STATUS  current
        DESCRIPTION
                "Table listing of all administered 
                 FRAS Host BNN entries on this node.
                 Entries in this table can be created via
                 a CLI command or via frasHostBnnAdminRowStatus."
        ::= { frasHostAdminObjects 1 }

frasHostBnnAdminEntry OBJECT-TYPE
        SYNTAX  FrasHostBnnAdminEntry
        MAX-ACCESS  not-accessible
        STATUS  current
        DESCRIPTION
                "Each entry represents an administered 
                 FRAS Host BNN Entry on this node."
        INDEX   { frasHostBnnVirtualRingIf,
                  frasHostBnnFrameRelayIf,
                  frasHostBnnAdminHostMac,
                  frasHostBnnAdminFrLocalSap }
        ::= { frasHostBnnAdminTable 1 }

FrasHostBnnAdminEntry ::= SEQUENCE {
        frasHostBnnVirtualRingIf
                InterfaceIndex,
        frasHostBnnFrameRelayIf
                InterfaceIndex,
        frasHostBnnAdminHostMac
                MacAddressNC,
        frasHostBnnAdminFrLocalSap
                SAPType,
        frasHostBnnAdminHostSap
                SAPType,
        frasHostBnnAdminVirtualMac
                MacAddressNC,
        frasHostBnnAdminRowStatus
                RowStatus
        }

frasHostBnnVirtualRingIf OBJECT-TYPE
        SYNTAX      InterfaceIndex
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION 
            "The ifIndex value for the Virtual
             Token Ring Interface."
        ::= { frasHostBnnAdminEntry 1 }

frasHostBnnFrameRelayIf OBJECT-TYPE
        SYNTAX      InterfaceIndex
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION 
            "The ifIndex value for the Frame
             Relay interface or subinterface."
        ::= { frasHostBnnAdminEntry 2 }

frasHostBnnAdminHostMac OBJECT-TYPE
        SYNTAX      MacAddressNC
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION 
            "This value is the Mac Address 
             of the Host device."
        ::= { frasHostBnnAdminEntry 3 }

frasHostBnnAdminFrLocalSap OBJECT-TYPE
        SYNTAX      SAPType
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION 
            "This value is the Local Sap Address on FRAS 
             BNN LLC-2 frames that are received from or
             sent to a remote device across Frame Relay."
        ::= { frasHostBnnAdminEntry 4 }

frasHostBnnAdminHostSap OBJECT-TYPE
        SYNTAX      SAPType
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
            "This value is the Sap Address 
             of the Host device."
        ::= { frasHostBnnAdminEntry 5 }

frasHostBnnAdminVirtualMac OBJECT-TYPE
        SYNTAX      MacAddressNC
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
            "This value is a Virtual Mac Address template used to 
             dynamically create Mac Addresses for BNN connections. The 
             last 2 bytes of this value must be administered as zero, 
             since Mac Addresses for BNN connections are formed by 
             putting the DLCI (in hexadecimal format) in the last 2 
             bytes of this virtual Mac Address."
        ::= { frasHostBnnAdminEntry 6 }

frasHostBnnAdminRowStatus OBJECT-TYPE
        SYNTAX  RowStatus
        MAX-ACCESS  read-create
        STATUS  current
        DESCRIPTION
            "Used by a Management Station to create or delete the row 
             entry in the frasHostBnnAdminTable following the RowStatus 
             textual convention.  

             The values in this table cannot be changed after creation.  
             The only way to change them is to destroy the row 
             entry, and create it again, using the new values.

             The Management Station can set the value to 'destroy (6)' 
             and the Agent will then delete the rows corresponding 
             to this PU from the frasHostBnnAdminTable."
        ::= { frasHostBnnAdminEntry 7 }        

--
-- Define frasHostBnnAdminTable
--
frasHostBanAdminTable OBJECT-TYPE
        SYNTAX  SEQUENCE OF FrasHostBanAdminEntry
        MAX-ACCESS  not-accessible
        STATUS  current
        DESCRIPTION
                "Table listing all administered FRAS Host 
                 BAN entries on this node. Entries in this 
                 table can be created via a CLI command or 
                 via frasHostBanAdminRowStatus."
        ::= { frasHostAdminObjects 2 }

frasHostBanAdminEntry OBJECT-TYPE
        SYNTAX  FrasHostBanAdminEntry
        MAX-ACCESS  not-accessible
        STATUS  current
        DESCRIPTION
                "Each entry represents an administered FRAS Host 
                 BAN Entry on this node."
        INDEX   { frasHostBanVirtualRingIf,
                  frasHostBanFrameRelayIf,
                  frasHostBanBoundNodeId }
        ::= { frasHostBanAdminTable 1 }

FrasHostBanAdminEntry ::= SEQUENCE {
        frasHostBanVirtualRingIf
                InterfaceIndex,
        frasHostBanFrameRelayIf
                InterfaceIndex,
        frasHostBanBoundNodeId
                MacAddressNC,
        frasHostBanAdminHostMac
                MacAddressNC,
        frasHostBanAdminRowStatus
                RowStatus
        }

frasHostBanVirtualRingIf OBJECT-TYPE
        SYNTAX      InterfaceIndex
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION 
            "The ifIndex value for the Virtual
             Token Ring Interface."
        ::= { frasHostBanAdminEntry 1 }

frasHostBanFrameRelayIf OBJECT-TYPE
        SYNTAX      InterfaceIndex
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION 
            "The ifIndex value for the Frame
             Relay interface or subinterface."
        ::= { frasHostBanAdminEntry 2 }

frasHostBanBoundNodeId OBJECT-TYPE
        SYNTAX      MacAddressNC
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION 
            "This value is the Boundary Node ID which
             is the local Mac Address for Frame Relay 
             BAN-encapsulated frames."
        ::= { frasHostBanAdminEntry 3 }

frasHostBanAdminHostMac OBJECT-TYPE
        SYNTAX      MacAddressNC
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION 
            "This value is the Mac Address 
             of the Host device."
        ::= { frasHostBanAdminEntry 4 }

frasHostBanAdminRowStatus OBJECT-TYPE
        SYNTAX  RowStatus
        MAX-ACCESS  read-create
        STATUS  current
        DESCRIPTION
            "Used by a Management Station to create or 
             delete the row entry in the frasHostBanAdminTable 
             following the RowStatus textual convention.

             The values in this table cannot be changed after creation.  
             The only way to change them is to destroy the row 
             entry, and create it again, using the new values.

             The Management Station can set the value to 'destroy (6)' 
             and the Agent will then delete the rows corresponding 
             to this PU from the frasHostBanAdminTable."
        ::= { frasHostBanAdminEntry 5 }        

--
-- Define frasHostDlswAdminTable
--
frasHostDlswAdminTable OBJECT-TYPE
        SYNTAX  SEQUENCE OF FrasHostDlswAdminEntry
        MAX-ACCESS  not-accessible
        STATUS  current
        DESCRIPTION
                "Table listing all Virtual Token Rings
                 on which LLC-2 termination via DLSw+
                 is configured for FRAS Host. Entries in 
                 this table can be created via Command 
                 Line Interface or via frasHostDlswAdminRowStatus."
        ::= { frasHostAdminObjects 3 }

frasHostDlswAdminEntry OBJECT-TYPE
        SYNTAX  FrasHostDlswAdminEntry
        MAX-ACCESS  not-accessible
        STATUS  current
        DESCRIPTION
                "Each entry represents a Virtual Token Ring
                 on which LLC-2 termination via DLSw+
                 is configured for FRAS Host."
        INDEX   { frasHostDlswVirtualRingIf }
        ::= { frasHostDlswAdminTable 1 }

FrasHostDlswAdminEntry ::= SEQUENCE {
        frasHostDlswVirtualRingIf
                InterfaceIndex,
        frasHostDlswAdminRowStatus
                RowStatus
        }

frasHostDlswVirtualRingIf OBJECT-TYPE
        SYNTAX      InterfaceIndex
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION 
            "The ifIndex value for the Virtual
             Token Ring Interface."
        ::= { frasHostDlswAdminEntry 1 }

frasHostDlswAdminRowStatus OBJECT-TYPE
        SYNTAX  RowStatus
        MAX-ACCESS  read-create
        STATUS  current
        DESCRIPTION
            "Used by a Management Station to create or
             delete the row entry in the 
             frasHostDlswLocalAckTable following the RowStatus
             textual convention.

             The values in this table cannot be changed after creation.
             The only way to change them is to destroy the row
             entry, and create it again, using the new values.

             The Management Station can set the value to 'destroy (6)'
             and the Agent will then delete the rows corresponding
             to this entry from the frasHostDlswLocalAckTable."
        ::= { frasHostDlswAdminEntry 2 }        

--
-- Define frasHostConnTable
--
frasHostConnTable OBJECT-TYPE
        SYNTAX  SEQUENCE OF FrasHostConnEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
                "Table listing all FRAS Host Connections
                 that are owned by this FRAS Host node."
        ::= { frasHostConnObjects 1 }

frasHostConnEntry OBJECT-TYPE
        SYNTAX      FrasHostConnEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
                "Each entry represents a FRAS Host 
                 Connection (BAN or BNN)."
        INDEX   { frasHostConnVirtualRingIf,
                  frasHostConnFrameRelayIf,
                  frasHostConnHostMac,
                  frasHostConnFrLocalSap,
                  frasHostConnRemoteMac,
                  frasHostConnRemoteSap }
        ::= { frasHostConnTable 1 }

FrasHostConnEntry ::= SEQUENCE {
        frasHostConnVirtualRingIf
                InterfaceIndex,
        frasHostConnFrameRelayIf
                InterfaceIndex,
        frasHostConnHostMac
                MacAddressNC,
        frasHostConnFrLocalSap
                SAPType,
        frasHostConnRemoteMac
                MacAddressNC,
        frasHostConnRemoteSap
                SAPType,
        frasHostConnHostSap
                SAPType,
        frasHostConnFrasType
                INTEGER,
        frasHostConnDlci
                INTEGER,
        frasHostConnBoundNodeId
                MacAddressNC,
        frasHostConnRifToHost
                OCTET STRING,                
        frasHostConnRifToRemote
                OCTET STRING,
        frasHostConnLocalTermination
                TruthValue,
        frasHostConnLastRxRemote
                TimeStamp,
        frasHostConnLastRxHost
                TimeStamp,
        frasHostConnFramesFwdRemote 
                Counter32,
        frasHostConnFramesFwdHost
                Counter32
}

frasHostConnVirtualRingIf OBJECT-TYPE
        SYNTAX      InterfaceIndex
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION 
            "The ifIndex value for the Virtual
             Token Ring Interface."
        ::= { frasHostConnEntry 1 }

frasHostConnFrameRelayIf OBJECT-TYPE
        SYNTAX      InterfaceIndex
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION 
            "The ifIndex value for the Frame
             Relay interface or subinterface."
        ::= { frasHostConnEntry 2 }

frasHostConnHostMac OBJECT-TYPE
        SYNTAX      MacAddressNC
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION 
             "This value is the Mac Address 
              of the Host device."
        ::= { frasHostConnEntry 3 }

frasHostConnFrLocalSap OBJECT-TYPE
        SYNTAX      SAPType
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION 
            "This value is the local Sap Address on FRAS
             BNN or BAN LLC-2 frames that are received from or
             sent to a remote device across Frame Relay."
        ::= { frasHostConnEntry 4 }

frasHostConnRemoteMac OBJECT-TYPE
        SYNTAX      MacAddressNC
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "This value is the Mac Address that is associated
             with the remote device.  For BNN, this address is
             a virtual Mac Address.  For BAN, this address is
             learned from the BAN frames received across a
             frame relay PVC."
        ::= { frasHostConnEntry 5 }

frasHostConnRemoteSap OBJECT-TYPE
        SYNTAX      SAPType
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "This value is the remote Sap Address on FRAS 
             BNN or BAN LLC-2 frames that are received from
             or sent to a remote device across Frame Relay."
        ::= { frasHostConnEntry 6 }

frasHostConnHostSap OBJECT-TYPE
        SYNTAX      SAPType
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "This value is the Sap Address 
             of the Host device."
        ::= { frasHostConnEntry 7 }

frasHostConnFrasType OBJECT-TYPE
        SYNTAX      INTEGER {
                        bnn (1),
                        ban (2)
        }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION 
            "This value is the type of FRAS 
             encapsulation used for this connection."
        ::= { frasHostConnEntry 8 }                       

frasHostConnDlci    OBJECT-TYPE
        SYNTAX      INTEGER (16..1007)
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "This value is the Data Link Connection 
             Identifier of the Frame Relay PVC on which 
             this LLC-2 connection is layered."
        ::= { frasHostConnEntry 9 }

frasHostConnBoundNodeId OBJECT-TYPE
        SYNTAX      MacAddressNC
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION 
           "This value is the Boundary Node ID which
            is the local Mac Address for Frame Relay 
            BAN-encapsulated frames.  For BNN-encapsulated frames 
            this is not applicable and will be returned 
            as 0000.0000.0000.  This address is in 
            Token Ring format"
        ::= { frasHostConnEntry 10 }

frasHostConnRifToHost   OBJECT-TYPE
        SYNTAX      OCTET STRING (SIZE (0..18))
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The Routing Information Field that is 
             placed in LLC-2 frames that FRAS Host forwards 
             to the Host for this connection.  A length of 
             zero indicates an invalid RIF."
        ::= { frasHostConnEntry 11 }

frasHostConnRifToRemote OBJECT-TYPE
        SYNTAX      OCTET STRING (SIZE (0..18))
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The Routing Information Field (or RIF) that is 
             placed in LLC-2 frames that FRAS Host forwards 
             to the remote device.  A length of zero indicates 
             Null RIF or invalid RIF."
        ::= { frasHostConnEntry 12 }

frasHostConnLocalTermination OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "This value is set to TRUE if the LLC-2 session
             corresponding to this entry is locally-terminated
             via DLSw+."
        ::= { frasHostConnEntry 13 }

frasHostConnLastRxRemote  OBJECT-TYPE
        SYNTAX      TimeStamp
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "This is the value of sysUpTime when a frame was 
             last received from the Remote device via Frame Relay."
        ::= { frasHostConnEntry 14 }

frasHostConnLastRxHost    OBJECT-TYPE
        SYNTAX      TimeStamp
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "This is the value of sysUpTime when a frame was 
             last received from the Host."
        ::= { frasHostConnEntry 15 }

frasHostConnFramesFwdRemote OBJECT-TYPE
        SYNTAX  Counter32
        MAX-ACCESS  read-only
        STATUS  current
        DESCRIPTION
            "Number of frames forwarded from the host 
             to the remote device over Frame Relay."
        ::= { frasHostConnEntry 16 }

frasHostConnFramesFwdHost OBJECT-TYPE
        SYNTAX  Counter32
        MAX-ACCESS  read-only
        STATUS  current
        DESCRIPTION
            "Number of frames forwarded from the remote
             device to the host."
        ::= { frasHostConnEntry 17 }

--
-- Conformance information
--
ciscoFrasHostMIBConformance  OBJECT IDENTIFIER ::= 
                                { ciscoFrasHostMIB 3 }
ciscoFrasHostMIBCompliances  OBJECT IDENTIFIER ::= 
                                { ciscoFrasHostMIBConformance 1 }
ciscoFrasHostMIBGroups       OBJECT IDENTIFIER ::= 
                                { ciscoFrasHostMIBConformance 2 }

-- Compliance statements
ciscoFrasHostMIBCompliance MODULE-COMPLIANCE
        STATUS  current
        DESCRIPTION
            "The compliance statement for all Cisco systems
             that implement the Cisco FRAS Host function."
        MODULE  -- this module
        MANDATORY-GROUPS  { frasHostBnnAdminGroup,
                            frasHostBanAdminGroup,
                            frasHostDlswAdminGroup,
                            frasHostConnGroup }
        ::= {ciscoFrasHostMIBCompliances 1}

-- Units of conformance

frasHostBnnAdminGroup OBJECT-GROUP 
        OBJECTS  { 
            frasHostBnnAdminHostSap,
            frasHostBnnAdminVirtualMac,
            frasHostBnnAdminRowStatus
        }
        STATUS  current
        DESCRIPTION
                "FRAS Host BNN admininistration information."
        ::= { ciscoFrasHostMIBGroups 1 }

frasHostBanAdminGroup OBJECT-GROUP 
        OBJECTS  { 
            frasHostBanAdminHostMac,
            frasHostBanAdminRowStatus
        }
        STATUS  current
        DESCRIPTION
                "FRAS Host BAN admininistration information."
        ::= { ciscoFrasHostMIBGroups 2 }

frasHostDlswAdminGroup OBJECT-GROUP
        OBJECTS {
            frasHostDlswAdminRowStatus
        }
        STATUS  current
        DESCRIPTION
                "FRAS Host DLSw+ Local Ack administration information."
        ::= { ciscoFrasHostMIBGroups 3 }

frasHostConnGroup OBJECT-GROUP 
        OBJECTS  {
            frasHostConnHostSap,
            frasHostConnFrasType,
            frasHostConnDlci,
            frasHostConnBoundNodeId,
            frasHostConnRifToHost,
            frasHostConnRifToRemote,
            frasHostConnLocalTermination,
            frasHostConnLastRxRemote,
            frasHostConnLastRxHost,
            frasHostConnFramesFwdRemote,
            frasHostConnFramesFwdHost
        }
        STATUS  current
        DESCRIPTION
                "FRAS Host connection information."
        ::= { ciscoFrasHostMIBGroups 4 }

-- end of conformance

END